home *** CD-ROM | disk | FTP | other *** search
/ Mac Format 1998 September / Macformat_MF67_1998-09.iso / Shareware Plus / Development / HexEdit 1.20 / Read Me! < prev    next >
Text File  |  1997-04-15  |  6KB  |  136 lines

  1. HexEdit v 1.2
  2.  
  3. Copyright © 1993 Jim Bumgardner <jbum@netcom.com>
  4. Portions Copyright © 1996 Lane Roathe <lane@xtremeplanet.com>
  5.  
  6. Here is my modified version of HexEdit, which I have placed at version 1.2 (v1.0x is from Jim Bumgardner, v1.1x is from Dave Polaschek)
  7.  
  8. ••• From Jim's original Docs:
  9.  
  10. HexEdit is a hexdump viewer and editor that works similarly to the hex editor provided with Apple's ResEdit.  It allows you to edit either the data fork or the resource fork of a file.
  11.  
  12. I wrote HexEdit because I needed to be able to insert/delete bytes from the data fork of files I was testing, and tools like FEdit don't have insert/deletion.
  13.  
  14. HexEdit is freeware.  The author retains the copyright, including the right to alter or sell the program.  You may use and copy HexEdit only on a non-commercial basis.  You may not sell this program without the author's permission.
  15.  
  16. ••• New features added:
  17.  
  18. • Ability to compare two files, & preferences for this feature
  19.  
  20. • Ability to switch between forks of the same file with a menu command,
  21.     even if the other fork has not been directly opened yet (ie, it auto-opens).
  22.  
  23. • Source code is now completely free of warnings (well, in CodeWarrior anyway)
  24.  
  25. • Source is now Universal Headers 2.x compatible
  26.  
  27. • Program is not "fat", with source modifications for Power PC compiles
  28.  
  29. About this Document
  30. ——————————
  31. In order to be brief, features which are similar to the ResEdit hex editor are not described. (If you aren't familiar with ResEdit, you probably shouldn't be using HexEdit).
  32.  
  33.  
  34. System Requirements
  35. ——————————
  36. HexEdit can edit very large files (they don't need to fit into memory).  At it's current memory setting of 600k, it should be able to handle files of up to 230 megs.  If you need to edit a larger file (!), increase it's memory partition.  
  37.  
  38. Note that when HexEdit saves a file, it will (temporarily) need twice the disc space of the original file, plus a little extra for storing the changes you have made.
  39.  
  40. Opening a File
  41. ——————————
  42. HexEdit supports drag and drop, automatically opening files in "Auto" mode.  You may find it useful to keep an alias to HexEdit on your desktop for this purpose.
  43.  
  44. When you use the Open command, HexEdit presents a standard file dialog with three radio buttons, labeled "Data" "Resource" and "Auto".
  45.  
  46. "Data" opens the data fork.
  47.  
  48. "Resource" opens the resource fork.
  49.  
  50. "Auto" opens the data fork, if there is any data in it, otherwise it opens the resource fork.
  51.  
  52.  
  53. Saving a File
  54. ————————
  55. When you save a file with HexEdit, it automatically backs up the last version of the file, renaming it to OriginalName~  (the original name with a tilde after it). You can turn this backup feature off in the Options menu.
  56.  
  57. The Find Menu
  58. ————————
  59. Find
  60. This brings up a dialog box allowing you to search for a sequence of hex bytes, or ascii
  61. text.
  62.  
  63. Search Forward
  64. This searches for  the last search string, forward until the end of the file.
  65.  
  66. Search Backward
  67. This searches for the last search string, backward until the beginning of the file.
  68.  
  69. Goto Address
  70. This allows you to specify an address, either in hex or in decimal, and scroll to that
  71. address.
  72.  
  73. The Options Menu
  74. ————————
  75.  
  76. Hi Order Ascii
  77. This displays ascii values in the ascii part of the dump which are higher than 80h - you will see the accents, diacriticals and symbols that are in the monaco font that HexEdit uses.  This also makes it a little harder to pick out English text if you are searching for it in a large binary.
  78.  
  79. Decimal Addresses
  80. This causes the addresses to be displayed in decimal, rather than hex.
  81.  
  82. Overwrite
  83. This toggles between insert mode (the default) and overwrite mode.  Overwrite mode allows you to replace a sequence of bytes without affecting the offset of the subsequent bytes.
  84.  
  85. Make Backups
  86. If checked, when saving a file ("filename"), rename the original file to "filename~" before saving the new data using the original filename. If not checked, the original file is overwritten and can not be restored.
  87.  
  88. Open and Compare Files…
  89. Brings up two standard file dialogs, allowing you to select two files which are then compared using the options specified in the Compare Options dialogs (see below). After selecting both files, you will have two windows, one above the other, with the first file in the top window. Below these windows will be a "dialog" which allows you to search forward or backward, edit the files, or exit. 
  90.  
  91. Compare Options…
  92. This dialog lets you choose how file compares are performed. You can choose the data size as well as if you want to display where files are similiar or where they differ.
  93.  
  94. Edit Other Fork
  95. Simply switches to the window containing the other fork for the file. If the window doesn't exist, HexEdit automatically opens the file's other fork in a new window and makes that window active.
  96.  
  97.  
  98. ••• Some Notes:
  99.  
  100. To help you in your perusal, I have marked all of my changes by //LR (usually followed by a descriptive comment, but not if it's "obvious", ha ha)
  101.  
  102. The original idea for file comparison was made by Jeff Smith.
  103.  
  104. Please, feel free to distribute this version of HexEdit as you please, I'd just ask for appropriate credit. I happen to use this program quite a bit, so if you make any changes please let me know, and I will try to get them into a new version.
  105.  
  106. Thanks to Jim for releasing such a fine program, and even more so for the source, as it's helped to make this program much more useful for myself and others! You may wish to check out IFD's mac web site, as it has several utilities w/source.
  107.  
  108. <http://www.ifd.com/mac>                  // mac site
  109. <http://www.fix.net/~lroathe>         // my site (interlinks abound)
  110. <http://www.genxsoftware.com> // we're working on cool stuff!
  111.  
  112. <lane@ricochet.net>        // wireless dude, what a rush!
  113.  
  114. Lane Roathe
  115. 115 Le Point St.
  116. Arroyo Grande, CA 93420
  117.  
  118. ————————
  119. Examples of what HexEdit has been/can be used for:
  120.  
  121.     Debugging:
  122.         Examining debugging data (ie, raw ADB output, etc.)
  123.         Examine other programs' binary output for errors (AIFF, MIDI, etc.)
  124.  
  125.     Spelunking:
  126.         Examine/Edit the contents of a MIDI file.
  127.         Examine binary files received from the Internet to see what format  they are in.
  128.         (MacBinary, Stuffit, etc.)
  129.  
  130.     Misc.:
  131.         Figure out how Kanji is encoded in a text file.
  132.         Compare MS-Word format to RTF format.
  133.         Examine the data fork of MS-Word Application
  134.         (Owner Name is stored there in easily decrypted format)
  135.     Recovery of damaged files, or at least portions of data therefrom.
  136.